home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / zgen160.zip / ZGEN.DOC < prev    next >
Text File  |  1991-06-13  |  39KB  |  1,119 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.       ZgenZgenZgenZgen
  10.       Zgen        Zgen
  11.                  Zgen
  12.               Zgen        ZgenZgen      ZgenZgenZgen  Zgen      Zgen
  13.           ZgenZgen      Zgen    Zgen    Zgen          ZgenZgen  Zgen
  14.           Zgen          Zgen            ZgenZgen      Zgen  ZgenZgen
  15.         Zgen            Zgen  ZgenZgen  Zgen          Zgen      Zgen
  16.       Zgen        Zgen  Zgen    Zgen    Zgen    Zgen  Zgen      Zgen
  17.       ZgenZgenZgenZgen    ZgenZgen      ZgenZgenZgen  Zgen      Zgen  v1.60
  18.  
  19.  
  20.       MS-DOS File and Archive Management Utility
  21.  
  22.       (c) copyright 1990, 1991 RWare Software Company
  23.  
  24.       ALL WORLDWIDE RIGHTS RESERVED
  25.  
  26.  
  27. 1
  28. ┌──────────────────────────────── Disclaimer ─────────────────────────────────┐
  29. │                                          │
  30. │  RWare makes no warranty of any kind, either express or implied,          │
  31. │  including but not limited to implied warranties of merchantability          │
  32. │  and fitness for a particular purpose, with respect to this software          │
  33. │  and accompanying documentation.                          │
  34. │                                          │
  35. │  IN NO EVENT SHALL RWARE BE LIABLE FOR ANY DAMAGES (INCLUDING           │
  36. │  DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF       │
  37. │  BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE      │
  38. │  OF THIS PROGRAM, EVEN IF RWARE HAS BEEN ADVISED OF THE POSSIBILITY OF      │
  39. │  SUCH DAMAGES.                                  │
  40. │                                          │
  41. │                                          │
  42. │  By using this program, you agree to these terms.                  │
  43. │                                          │
  44. └─────────────────────────────────────────────────────────────────────────────┘
  45.  
  46. Trademarks:
  47.  
  48. PKZIP, PKUNZIP and PKWARE are trademarks of PKWARE Inc.
  49. ARC is a trademark of System Enhancement Associates.
  50. PAK is a trademark of NoGate Consulting.
  51. MS-DOS is a trademark of the MicroSoft Corporation.
  52. 4DOS is a trademark of J.P. Software
  53. Borland C++ is a trademark of Borland International Inc.
  54. ARJ is a trademark of Robert K Jung.
  55.  
  56. The RWare Software company is not associated with the above firms.
  57.  
  58. License:
  59.  
  60. ZGEN is distributed under the shareware concept.  You are allowed to
  61. freely copy and distribute the unregistered versions of the files
  62. ZGEN.EXE and ZGEN.DOC without modification and in their entirety, and
  63. this program is not misrepresented as free or public domain software.
  64. No fee exceeding $6.00 U.S. may be charged for specific access to this
  65. program.  You are granted permission to use this software for a period
  66. of thirty (30) days.  At the end that period, you must either register
  67. ZGEN or discontinue use of ZGEN.
  68.  
  69. 2
  70.  
  71. Registering:
  72.  
  73. The registered version of ZGEN does not prompt you for your name and
  74. serial number.    The unregistered version is as fully functional as the
  75. registered version.
  76.  
  77. To register ZGEN, fill out this form completely :
  78. -------------------------------------------------------------------------------
  79.  
  80. RWare Software Company
  81. P.O.B. 2714
  82. Norman, OK 73070-2714
  83. USA
  84.  
  85.    Name:__________________________________________
  86.  
  87. Company:__________________________________________
  88.  
  89. Name for registration ( branded into executable ):
  90.  
  91.         __________________________________________
  92.  
  93. Address:__________________________________________
  94.  
  95.    City:_________________________  State:_________
  96.  
  97.     Zip:________________   Country:________________
  98.  
  99. Where did you get ZGEN v1.60?_____________________________
  100.  
  101. Computer Brand Name and Model :___________________________
  102.  
  103. Computer Processor: ( ) 8086/88 ( ) NEC V20/30 ( ) 80186/80188
  104.             ( ) 286 ( ) 386 ( ) 486
  105.  
  106. DOS vendor and version:___________________________________
  107.  
  108. Desired Disk format: ( ) 360K 5.25  ( ) 720K  3.5
  109.                      ( ) 1.2M 5.25  ( ) 1.44M 3.5
  110.  
  111. ZGEN registration costs $25 in North America, $28 elsewhere, payable
  112. in US currency.  Registration licenses two machines.  A 10% discount
  113. is available for orders over 10 in quantity.
  114.  
  115. By registering ZGEN, you will be given a serial number for your name
  116. that will register the shareware version of ZGEN.  This serial number
  117. will register all future upgrades of ZGEN.
  118.  
  119. You will also receive a disk with the next upgraded version of ZGEN,
  120. when it is released.
  121.  
  122.  
  123. Upgrade policy:
  124.  
  125. Upgrades will be offered at a nominal fee to cover media costs and
  126. postage.  RWare will send notices of changes in versions to registered
  127. users.  The RWare software company reserves the right to discontinue
  128. development of this software.
  129.  
  130. 3
  131.  
  132. What is ZGEN?
  133.  
  134. ZGEN is a directory program that provides an alternative to the DOS
  135. command line.  ZGEN gives the user freedom to zip through file directories
  136. and perform various actions on files that might be done from the DOS command
  137. line.  ZGEN also has the ability to search through the directories of
  138. various archives programs such as .ZIP files, .ARJ files, .LZH files
  139. and .ARC/.PAK files.  ZGEN will never directly alter an archive, it is
  140. done with the various archiving programs that you use.
  141.  
  142. ZGEN software requirements
  143.  
  144. ZGEN takes about 150K of free memory to run.  ZGEN requires DOS 3.0 or
  145. better, a listing program, and the archiving programs for the archive
  146. types that you use.
  147.  
  148. For a listing program, I suggest getting LIST written by Vernon D. Buerg.
  149. For users of 4dos, the internal list command does fine.
  150.  
  151. Since 4dos is mentioned in this document, and it is an excellent
  152. replacement for command.com, this is the address:
  153.  
  154. J.P. Software
  155. P.O. Box 1470
  156. E. Arlington, MA 02174
  157.  
  158. LIST is available as shareware, the latest version is LIST75F
  159.  
  160. Vernon D. Buerg
  161. 139 White Oak Circle
  162. Petaluma CA 94952
  163.  
  164.  
  165. PKZIP/PKUNZIP, written by Phil Katz is available as shareware.
  166. It supports the .ZIP archive format.
  167. It is usually in an archive called PKZ110.EXE
  168. Later versions of this software may have a higher version number.
  169.  
  170. PKWARE, Inc.
  171. 7545 N. Port Washington Rd.
  172. Glendale WI 53217.
  173.  
  174.  
  175. ARJ, written by Robert K Jung is available as freeware for
  176. non-commercial use. It supports the .ARJ file format. Its current
  177. version is 2.10.  I would recommend trying this archiver, it is currently
  178. the king of compression size, and is faster than LHA 2.12.
  179.  
  180. Robert K Jung
  181. 2606 Village Road West
  182. Norwood, Massachusetts 02062
  183.  
  184.  
  185. LHA, written by Haruyasu Yoshizaki is available as freeware.
  186. It supports the .LZH and .LZS archiving formats.
  187. Its current version is in a file LHA212.EXE, available on many BBS's.
  188.  
  189. 4
  190.  
  191. PAK, written by NoGate consulting, is available as shareware.
  192. It supports the .ARC, .PAK, .SDN and .ZIP file formats.
  193. Its current version is available in a file called PAK251.EXE,
  194. available on many BBS's
  195.  
  196. NoGate Consulting
  197. P.O. Box 88115
  198. Grand Rapids, MI 49518-0115
  199.  
  200. ZGEN also supports the background print spooler TSR program PRINT.COM
  201. to print files.  The program is available with MS-DOS starting at 3.0.
  202. ZGEN communicates with this program through the interrupt 2fh.  To
  203. install print, simply type "print" at the command line before you run
  204. ZGEN.
  205.  
  206. Installing ZGEN
  207.  
  208. To call ZGEN from any directory, place ZGEN in a directory that is
  209. specified by the DOS path environment variable.  To set it, use a
  210. statement like:
  211.  
  212. SET PATH=C:\;C:\UTILS;C:\TOOLS
  213.  
  214. where the directories to be searched are separated by semicolons.  See
  215. your MS-DOS reference manual for more information.
  216.  
  217. Place the file ZGEN.HLP in the same directory as ZGEN.EXE.  This file
  218. is used for context sensitive help, which is accessed by pressing
  219. <Alt-H>.
  220.  
  221. When ZGEN is first executed, it will create a configuration file
  222. called ZGEN.CFG in the same subdirectory as ZGEN.EXE, or in a directory
  223. specified by the environmental variable ZGEN.  ZGEN will also place
  224. directory tree map files in this directory named ZGEN.TRx where x is a
  225. drive letter. There is one for each fixed device logical drive.
  226.  
  227. On networks, the unregistered version needs to have write access to
  228. the ZGEN.EXE file.  Once the executable is registered with a valid
  229. serial number, this is no longer a requirment.  If write access is not
  230. given the the directory where ZGEN.EXE resides, use the environmental
  231. variable ZGEN to specify a writeable directory to store the ZGEN.CFG and
  232. ZGEN.TRx files.
  233.  
  234. The default configuration assumes that the files PKZIP.EXE,
  235. PKUNZIP.EXE, LHA.EXE, PAK.EXE and LIST.COM are in a directory
  236. specified by PATH.
  237.  
  238. If you wish to use the internal 4dos command list, change the viewing
  239. program command under options from "list %" to "*list %"
  240.  
  241. Command line
  242.  
  243. ZGEN accepts a command line consisting of a path to a directory.  ZGEN
  244. change to this directory if present.
  245.  
  246. 5
  247.  
  248. Main display
  249.  
  250. The main display is like the output from the command line "dir"
  251. command.  File entries are displayed with the file name, file size in
  252. bytes, time and date, file attributes, and description.
  253.  
  254.  
  255. One of the entries is contained in the select bar.  The select
  256. bar may be moved by using the up/down arrows,  and the display
  257. may be paged by using the <PgUp> and <PgDn> keys.  <Home> will move
  258. the select bar to the first entry, <End> will move the select bar to
  259. the last entry.  The space bar will display the main menu.
  260.  
  261. Pressing the <Enter> key will cause a certain action to occur to
  262. the selected entry.  If the entry is a directory, ZGEN will
  263. change to that directory.  If the entry is a program, such that it has
  264. the .exe, .com, .bat, and under 4dos 3.0+ the .btm extension, the file
  265. will be executed.  If the selected entry is an archive,  ZGEN will
  266. display the archives files.
  267.  
  268. ZGEN supports a feature borrowed from 4DOS called 'executable extensions'.
  269. If you set a an environmental variable for a certain filename extension
  270. such as 'SET .GIF=SHOWGIF', ZGEN will execute 'SHOWGIF <filename>'
  271. when <Enter> if the selected file has an extension of '.GIF' and
  272. <Enter> is pressed.  Note that a copy of the command interpreter is
  273. used for each file executed in this way.
  274.  
  275. In all other cases, the view file command is used on the selected
  276. file.
  277.  
  278. Pressing the <Esc> key will cause ZGEN to move to the parent
  279. directory of the current directory, or if inside an archive,
  280. return to the DOS directory.
  281.  
  282. Pressing a letter key will scroll the select bar to the next entry
  283. that begins with this letter, if such an entry exists.
  284.  
  285. Pressing '\' will change the directory to the root directory of the
  286. current drive.
  287.  
  288.  
  289. Mouse
  290.  
  291. If there is a mouse installed, you may use the mouse for
  292. navigating through ZGEN.  If the mouse has three buttons, the
  293. middle button may be used to display the main menu.
  294.  
  295. 6
  296.  
  297. An entry may be selected by moving the mouse cursor to the line
  298. that contains the entry the entry and pressing the left button.
  299. Pressing the left button on while the mouse cursor is on the
  300. selected entry is the same as pressing the <Enter> key.
  301.  
  302. Pressing the right mouse button will give context sensitive help if
  303. available.
  304.  
  305. Clicking on the second line is like pressing <Alt-Y>, the change
  306. directory command.
  307.  
  308. Clicking on the any of the first three characters of an entry will
  309. toggle the tag status of that entry.  This is like pressing <Tab> from
  310. the keyboard.  Note that directories cannot be tagged.
  311.  
  312. Clicking on the file name will is like pressing <Enter>.
  313.  
  314. Clicking on a file size is like press <Del>.
  315.  
  316. Clicking on a description is like pressing <Ctrl-D>.
  317.  
  318. Clicking on either the top or bottom arrow of the scroll bar on the right
  319. side of the display will move the select bar up or down, clicking directly
  320. on the scroll bar will move you to the approximate place in the list.
  321.  
  322. Clicking on ZGEN v1.60 is the same as pressing <Esc>
  323.  
  324. Menu operations
  325.  
  326. When a main menu is invoked, it displays a list of options.  Each option
  327. is a brief description of the command.  If the command has a hotkey, it
  328. is displayed to the right of the option.  The convention used for naming
  329. keys is as follows:   '@' stands for <Alt>, and '^' stands for <Ctrl>.
  330. For example, @D means <Alt D> and is used by pressing down the <Alt> key
  331. followed by the <D> key and then releasing.  Using a hotkey bypasses
  332. navigating through menus.
  333.  
  334. A menu has a select bar.  The up and down arrow keys are used to move
  335. the select bar.  To invoke the option, press <Enter>.  Pressing <Esc>
  336. will return you from the menu.
  337.  
  338. Each option will have a letter in the window highlight color.  Pressing
  339. that letter on the keyboard will invoke that option.
  340.  
  341. When in a menu, pressing <Alt-H> will give context sensitive help.
  342.  
  343.  
  344. Subdirectory Tree display
  345.  
  346. The subdirectory tree display is invoked when using the go to
  347. directory, copy, and move commands.  The arrow keys and <PgUp>,
  348. <PgDn>, <Home>, <End> keys move the select bar.  Select the desired
  349. directory to complete the command and press <Enter>.  To abort the
  350. command, press <Esc>.  Pressing a letter key will scroll the select
  351. bar to the next entry beginning with that letter, if such an entry
  352. exists.
  353.  
  354. 7
  355.  
  356. Pressing the space bar will activate the subdirectory tree menu.
  357.  
  358. The first time that the subdirectory tree is used, ZGEN will build a
  359. directory tree for the current drive and display the message: "wait -
  360. reading directory tree".  This only occurs when the directory
  361. structure has been changed from ZGEN, such as removing or creating a
  362. directory, or if the Reread directory tree command has been selected,
  363. or if the logical drive is not a fixed disk, or if ZGEN finds that a
  364. selected directory no longer exists.
  365.  
  366. Subdirectory Tree Menu
  367.  
  368. Change Drive
  369. <Alt D>
  370.  
  371.    This command allows you to select a directory on a different
  372.    logical drive.  Selecting a different drive displays a directory
  373.    tree of that drive.  Note that this does not change the currently
  374.    logged drive unless the 'directory' command is used.
  375.  
  376. Make directory
  377. <Alt K>
  378.  
  379.    This command allows you to create a subdirectory in the currently
  380.    selected subdirectory.  It is useful for creating a destination
  381.    directory on the fly when copying or moving files.  You will be
  382.    prompted for a name for the new subdirectory.  Afterwards, the
  383.    directory tree will be reread, and the select bar will move to the
  384.    new directory.
  385.  
  386. Reread dir tree
  387. <Alt R>
  388.  
  389.    This command rereads the directory tree structure from the disk.
  390.    You use this if you have altered the subdirectory tree structure
  391.    outside of ZGEN.
  392.  
  393. Print this dir tree
  394. <Alt P>
  395.  
  396.    This command sends a copy of the directory tree structure to the
  397.    printer.  It's useful if you like to have a hard copy of the
  398.    subdirectory tree display.
  399. 8
  400.  
  401. Quit - current dir
  402. <Alt Q>
  403.  
  404.    This command terminates ZGEN and returns you to the current
  405.    directory.
  406.  
  407. Exit - original dir
  408. <Alt X>
  409.  
  410.    This command terminates ZGEN and returns you to the directory that
  411.    you were in when ZGEN was executed.
  412.  
  413.  
  414. Main Menu
  415.  
  416. Copy/unarc files
  417. <Alt C>
  418.  
  419.      This option will copy the tagged or selected files to a specified
  420.      directory.  The directory is specified by using the directory
  421.      tree.  If the file(s) is/are inside an archive the archive's
  422.      unarchive command is used.  See the archive option menu
  423.      description for details on how this command works.  If no files
  424.      are tagged, and the selected entry is a directory, the contents of
  425.      that directory, including any subdirectories will be copied to the
  426.      destination directory.  Files may also be copied or duplicated to
  427.      the current directory, in which case you will be prompted for the
  428.      name of the file.
  429.  
  430. Directory
  431. <Alt Y>
  432.  
  433.      This function allows you to change to a different directory.  The
  434.      subdirectory tree is displayed to allow you to select the
  435.      directory you wish to change to.
  436.  
  437. Change drive
  438. <Alt D>
  439.  
  440.      This function allows you to change to a different logical drive.
  441.      A menu with a list of the currently valid logical drives is
  442.      displayed.  When you change to a different drive, ZGEN displays
  443.      the current directory of that drive.
  444.  
  445. 9
  446. View file
  447. <Alt V>
  448.  
  449.      This option invokes the viewing command for the selected
  450.      file, or the archive view file command, for files inside
  451.      archives.    You may view a file that is not an archive or program
  452.      by pressing <Enter> instead of using this command.
  453.  
  454. Archive create/view menu
  455.  
  456. create archive file
  457. <Alt A>  .arc/.pak
  458. <Alt L>  .lzh
  459. <Alt Z>  .zip
  460. <Alt J>  .arj
  461.  
  462.      These options allow you to create an archive for the supported
  463.      archive types. If a create archive function is invoked, all of
  464.      the tagged files will be added to an archive file that you
  465.      specify. If no files are tagged, the selected file is added to an
  466.      archive.  You will be prompted for a name for the archive.  See
  467.      the archive option menu description for more details on how this
  468.      function works.
  469.  
  470. force archive file
  471. <Ctrl A> .arc/.pak
  472. <Ctrl L> .lzh
  473. <Ctrl Z> .zip
  474. <Ctrl J> .arj
  475.  
  476.      These options force ZGEN to display the directory of the selected
  477.      file that is an archive that does not match the archive type's
  478.      aliases.  If the archive file does not match an alias, it is not
  479.      displayed with the archive file color.  Note that these functions
  480.      will allow you to view a self extracting archive.
  481.  
  482. Make directory
  483. <Alt K>
  484.  
  485.      This function allows you to create a subdirectory in the current
  486.      directory.  You will be prompted for a name.
  487.  
  488. 10
  489.  
  490. Move file(s)
  491. <Alt M>
  492.  
  493.      This function will move all the tagged files, or the selected
  494.      file if none are tagged.  The subdirectory tree display is used
  495.      to select the destination directory. If the selected entries are
  496.      inside an archive, they are simply unarchived.
  497.  
  498. Rename file
  499. <Alt N>
  500.  
  501.      This function allows you to rename the selected file.  You will
  502.      be prompted for a new name for the file.  Note that wildcards do
  503.      not work with this function.
  504.  
  505.  
  506. Printer Menu
  507.  
  508. Print file(s)
  509. <Alt P>
  510.  
  511.      This function allows you to print a file.  If the DOS program
  512.      print.com has been installed, the selected file is sent to the
  513.      printer queue, otherwise, the file is printed directly.  If the
  514.      file is inside an archive, the file is printed using that
  515.      archive's command for printing a file.  See the archive command
  516.      options for further details.
  517.  
  518. Edit print queue
  519. <Ctrl Q>
  520.  
  521.      This option is only valid if print.com has been installed. This
  522.      function allows you to view and delete files from the print
  523.      queue.  It shows a list of the current state of the queue and
  524.      halts printing.  You may delete a file from the queue by
  525.      selecting it and pressing <Del>
  526.  
  527.  
  528. Cancel printing
  529. <Ctrl C>
  530.  
  531.      This option is only valid if print.com has been installed. This
  532.      option terminates the printing of all files in the print queue.
  533.  
  534. 11
  535.  
  536. Delete file(s)
  537. <DEL>
  538.  
  539.      This option allows you to delete all of the tagged files, or if
  540.      none are tagged, the selected entry.  If the selected entry is a
  541.      directory, this command will remove that directory and all files
  542.      contained within it.  Note that if the verify mode is off, you
  543.      will not be asked for verification before deleting the files.
  544.  
  545.  
  546. Find a file
  547. <Alt F>
  548.  
  549.      This option allows you to locate a file on the current logical
  550.      drive.  You will prompted for a filename, and this file name can
  551.      contain wildcard characters such as '*' and '?'.  This option
  552.      will also ask you if you want to search inside any archive files
  553.      after a normal file search.
  554.  
  555. Configuration menu
  556. <Alt O>
  557.  
  558.      This menu allows you to configure various aspects of ZGEN.
  559.  
  560. Colors
  561.  
  562.      This menu allows you to define various colors that ZGEN displays.
  563.  
  564.      "Status lines" and "status line highlight" are the colors of the
  565.      top two lines and the bottom line.
  566.  
  567.      "Marker" is the color of the marker character for tagged files
  568.      and mouse cursor. The marker character is displayed in the first
  569.      column of the main display.
  570.  
  571.      "Select bar" is the color of the currently selected entry in the
  572.      main display, directory in the subdirectory tree display, and
  573.      selected option in the menus.
  574.  
  575.      "Directory" is the color of directory entries.
  576.  
  577.      "Archives" is the color of any file that matches an archive alias.
  578.  
  579.      "Programs" is the color of an .exe, .com, .bat and under 4dos 3.0+,
  580.      .btm files.
  581.  
  582. 12
  583.      "Other files" the files is the color of directory entries not
  584.      covered by the above cases.
  585.  
  586.  
  587. Display lower case filenames
  588.  
  589.      Switching this option to yes displays filenames as lower case in
  590.      the main display.  Directory names will still be displayed as
  591.      upper case.
  592.  
  593. Directory sort method
  594.  
  595.      This allows you to specify the sort order that ZGEN uses to
  596.      display the entries.  Note that in all cases, subdirectories will
  597.      be displayed first.
  598.  
  599.      No sort:
  600.  
  601.      Files are displayed in DOS creation order.  Specifying this
  602.      method will speed up directory loading speed.
  603.  
  604.      Sort alphabetically by name:
  605.  
  606.      Directories and filenames are sorted alphabetically, with
  607.      directories preceding files.
  608.  
  609.      Sort alphabetically by ext.:
  610.  
  611.      This is like the above method, except that the files are sorted
  612.      by file extension before sorting by the main part of the name.
  613.  
  614.      Sort by size, smallest/largest first:
  615.  
  616.      These methods sort filenames by the size of the file.
  617.  
  618.      Sort by time/date, earliest/latest first:
  619.  
  620.      Files are sorted by the time/date indicated in the directory
  621.      entry.
  622.  
  623. 13
  624.  
  625. Command Syntax
  626.  
  627.      Various options, such as the file viewing program, archive
  628.      options, and user commands allow you to specify a command.  A
  629.      command is a name of a program or a command interpreter
  630.      instruction.  A command may contain the following symbols:
  631.  
  632.             %    name of the selected entry
  633.             %.   name of the selected entry without extension
  634.             %:   name of the current directory
  635.             %a   name of the archive file that is being viewed
  636.             %p   pause after program execution
  637.         %s     swap to run program
  638.         %ns  do not swap to run program
  639.             %^   compound statement separator
  640.         *     (at start of command) invoke command interpreter for
  641.          this command.
  642.  
  643.      The %s and %ns override the enable swapping option ( see swapping
  644.      menu )
  645.  
  646.      To run a .bat or .btm file, you must either specify the extension
  647.      in the command or precede the command with a '*'. All programs
  648.      specified in commands are searched for by using the path
  649.      environmental variable.
  650.  
  651. File viewing program
  652.  
  653.      This function allows you to specify the file viewing command.
  654.      The default is "list %".  This assumes that the program is on the
  655.      path.  The name of the currently selected entry is replaces the
  656.      "%" in the command.   For users of 4dos that wish to use the
  657.      internal 4dos list command, precede the command with a '*' such
  658.      that it is "*list %".  The '*' tells ZGEN to execute the command
  659.      interpreter to complete this command.
  660.  
  661. Format program
  662.  
  663.      This function allows you to specify a program to format unformatted
  664.      floppy disks.  When ZGEN tries to access a floppy and it appears to
  665.      unformatted, you will be given the option to run this program.  The
  666.      "%" parameter will be substituted for the name of the drive with a
  667.      colon, i.e.  "A:".
  668.  
  669. 14
  670.  
  671. Archive file options
  672.  
  673.      These are the various commands that ZGEN executes for operations
  674.      on archive files.  Note that ZGEN itself does no direct
  675.      alteration of archives and relies on these commands to do archive
  676.      operations.
  677.  
  678.      The default commands assume that you have the programs
  679.      pkunzip.exe, pkzip.exe, pak.exe, lharc.com, and list.com on the
  680.      path.
  681.  
  682.      Unarchive file:
  683.  
  684.      This is the command used when a single file has been selected to
  685.      be unarchived with the copy/unarchive function.  Place "%a" in
  686.      this command where the archive file needs to be placed. Place the
  687.      "%" where the name of the file inside the archive needs to be
  688.      placed.  Note that when this command is invoked, ZGEN has
  689.      switched to the destination directory and uses the full path
  690.      name to the archive for the "%a" parameter.
  691.  
  692.      Archive file:
  693.  
  694.      This is the command used when creating a new archive from a
  695.      single file with a create archive file command.  The "%a"
  696.      specifies the name of the archive file.  "%" specifies the name
  697.      of file to be archived.
  698.  
  699.      Delete file:
  700.  
  701.      This command is used when the delete file command has be invoked
  702.      for a single file.
  703.  
  704. 15
  705.  
  706.      View file:
  707.  
  708.      This is the command invoked when <Enter> has been pressed on an
  709.      entry inside an archive or the view file command was selected for
  710.      that entry.  The default commands use the command interpreter to
  711.      pipe output from the unarchiving programs into the list program.
  712.      This may cause problem viewing archives on a diskette that is
  713.      full.   A solution is to create a batch file like this:
  714.  
  715.           viewzip.bat
  716.       ---------------------
  717.           pkunzip -x %1 %2 c:\
  718.           list c:\%2
  719.           del c:\%2
  720.       ---------------------
  721.  
  722.      and changing the command to this:
  723.  
  724.           viewzip.bat %a %
  725.  
  726.  
  727.      Print file
  728.  
  729.      This is the command used when the Print file function is used on a
  730.      file inside an archive.
  731.  
  732.      Describe file
  733.  
  734.      This is the command used to create a description for an single
  735.      entry inside an archive.  It may be left blank.  Currently, lha
  736.      does not support file descriptions.
  737.  
  738.      Unarchive list
  739.  
  740.      This command is used when the copy/unarchive files command is
  741.      used when there is a list of tagged files to be unarchived.  It
  742.      may be left blank, and in that case the unarchive command is used
  743.      repeatedly.  ZGEN creates a temporary file that contains the
  744.      names of the files to be unarchived and passes this filename in
  745.      the "%" parameter.
  746.  
  747. 16
  748.      Archive list
  749.  
  750.      This command is used when a set of tagged files is to be archived
  751.      with the create archive file function  Like the unarchive list
  752.      command,  ZGEN creates a temporary file with a list of files to
  753.      be archived and passes this files's name in the "%" parameter.
  754.      This command may be left blank, and in that case the archive file
  755.      command is used repeatedly.
  756.  
  757.      Delete list
  758.  
  759.      This command is used when a set of tagged files in an archive are
  760.      to be deleted with the Delete files command.  Like the above two
  761.      commands, a temporary file is created with a list of file names
  762.      to deleted in the archive.  This command may be left blank, and
  763.      in that case, the delete file command is used repeatedly.
  764.  
  765.      Unarchive with password
  766.  
  767.      Currently only .zip and .arj files provide a means of detecting
  768.      if a file inside an archive is encrypted.    If an encrypted file
  769.      is to be unarchived, this command is used.  The "%e" parameter is
  770.      a password that you will be prompted for.    This command may be
  771.      left blank for the other archive types.
  772.  
  773.      Aliases
  774.  
  775.      This is a list of file masks that are to be treated as of this
  776.      archive type. Each mask is delimited by a space.  These
  777.      file masks may contain the DOS wildcards '*' and '?'.  There is also
  778.      another wildcard '#' that will match '0','1','2','3','4','5','6','7',
  779.      '8','9' and '#'.  You may disable an archive ZGEN from dealing with
  780.      a certain archive type by leaving this entry blank.
  781.  
  782.  
  783. Swapping options
  784.  
  785.      ZGEN uses swapping code written by Ralph Brown.  This enables
  786.      ZGEN to swap out of memory when executing a command or a program,
  787.      such as the file viewing program, the archive commands, and the
  788.      user commands.
  789.  
  790.      Enable swapping
  791.  
  792. 17
  793.  
  794.      This option allows you to disable swapping completely.  In that
  795.      case, ZGEN takes up about 160K of DOS memory, but executes things
  796.      a little faster.
  797.  
  798.      Use XMS memory if available?
  799.  
  800.      By default ZGEN will try to use XMS memory to swap if it finds
  801.      it.  You may disable this by toggling this option to no.
  802.  
  803.      Use EMS memory if available?
  804.  
  805.      If any EMS memory is available, ZGEN will use this for swapping.
  806.      You may disable this by toggling this option to no.
  807.  
  808.      Disk overlay path
  809.  
  810.      If ZGEN finds no EMS or XMS memory to use for swapping, ZGEN will
  811.      swap to disk.  This is the path to where you would like ZGEN to
  812.      place the swap file.  This file is about 160K in size.
  813.  
  814. Enable Mouse
  815.  
  816.      If you do not use your mouse with ZGEN and don't want to see the
  817.      mouse cursor, you may disable the mouse by switching this option
  818.      to no.
  819.  
  820. Other menu:
  821.  
  822. Toggle verify mode
  823. <Alt T>
  824.  
  825.      This option toggles the status of the verify mode. The current state is
  826.      displayed in the lower right hand corner of the main display.
  827.      If verify mode is toggled on, ZGEN will ask you if you want to
  828.      delete files with delete command, or overwrite them with the copy
  829.      or move files command.  ZGEN will always ask for verification if
  830.      you try to delete a directory with files in it.  You may toggle
  831.      the verify mode with the mouse by clicking the right mouse button
  832.      on the verify status message in the main display.
  833.  
  834. View DOS screen
  835. <Alt S>
  836.  
  837.      ZGEN saves the DOS screen on entry and uses it whenever it runs
  838.      an external program.  You may view this screen by selecting this
  839.      option.  Pressing any key brings you back to the ZGEN display.
  840.  
  841. 18
  842.  
  843. Mark file
  844. <+>
  845.  
  846.      This option marks the currently selected entry and moves the
  847.      select bar down. A tagged entry has the '»' character in front of
  848.      it. Directory entries cannot be marked.
  849.  
  850. Unmark file
  851. <->
  852.  
  853.      This option unmarks the currently selected entry and moves the
  854.      select bar down.
  855.  
  856.  
  857. Toggle mark
  858. <TAB>
  859.  
  860.      This option toggles the marking status of the currently selected
  861.      entry and moves the select bar down.  Note that directory entries
  862.      cannot be tagged.  You may use the mouse to toggle the tag of an
  863.      entry by clicking the left mouse button on any of the first three
  864.      characters of an entry.
  865.  
  866. Change file attributes
  867. <Ctrl T>
  868.  
  869.      this option allows you to change the file attributes of a file.
  870.      A small menu pops up so you can set the status of the various
  871.      attributes you want to change.
  872.  
  873.      Readonly - setting this bit prevents the file from being changed
  874.      or deleted by DOS.
  875.  
  876.      Hidden - setting this bit will exclude the file from being
  877.      listed in a DOS directory.
  878.  
  879.      System - this bit is rarely used, but it works like the hidden
  880.      bit.  Usually the file io.sys and msdos.sys have this bit set.
  881.  
  882.      Archive - this bit is set whenever a file has been changed.  A
  883.      backup program usually will clear this bit.  This bit is used to
  884.      indicate that a file has not been backed up.
  885.  
  886. 19
  887.  
  888. Describe file
  889. <Ctrl D>
  890.  
  891.      This option allows you to create or change a description for a
  892.      file.  For normal files, the descriptions are stored in a hidden
  893.      file called DESCRIPT.ION.  This file uses the same format as the
  894.      file descriptions used in 4dos. If a file with a description is
  895.      moved or copied by ZGEN, the description will go with it.  If a
  896.      file is inside and archive, this option will use the describe
  897.      file command for that archive type.
  898.  
  899.  
  900. Create volume label
  901. <Ctrl V>
  902.  
  903.      This option allows you to create or change the volume label of
  904.      the current logical drive.  Note that some programs create
  905.      non-standard volume labels that cannot be changed by ZGEN.
  906.  
  907. Edit user commands
  908. <Alt E>
  909.  
  910.       You may assign external programs to be executed by ZGEN to the
  911.       function keys F1-F10.  These commands use the symbols listed
  912.       under command syntax.   For example, if you have an editor
  913.       program called edit.exe that is in a directory on the path, you
  914.       may create a command that edits the currently selected file by
  915.       using the command "edit %".  The "%" will be replaced by the
  916.       selected entry's filename.
  917.  
  918. Execute user commands
  919.  
  920.       This menu shows the assignment of the various user commands.
  921.  
  922. Run selected program
  923. <Alt R>
  924.  
  925.       This option will allow you to run the currently selected entry
  926.       if it is a program, that is, if it has the .exe, .com, .bat and
  927.       under 4dos 3.0+, the .btm file extension.  This option will
  928.       prompt you for any parameters for the program.
  929.  
  930. 20
  931.  
  932. Command line
  933. <*>
  934.  
  935.  
  936.    This command will prompt you for a command line to be executed by
  937.    the command interpreter.  It may be anything that you would type at
  938.    the DOS prompt.   Note that environmental variables will not retain
  939.    the values when you use the set command from here.  You can also
  940.    shell from ZGEN by pressing <Enter> with a blank line here.
  941.  
  942. Quit - current dir
  943. <Alt Q>
  944.  
  945.    This command terminates ZGEN and returns you to the currently
  946.    logged directory.
  947.  
  948. Exit - original dir
  949. <Alt X>
  950.  
  951.    This command terminates ZGEN and returns you to the directory that
  952.    you were in when ZGEN was executed.
  953.  
  954. ZGEN Error Messages:
  955.  
  956. Invalid Directory
  957.   - An invalid directory was specified.  This error may
  958.     occur if a floppy disk was swapped on ZGEN.
  959.  
  960. Invalid Drive
  961.   - The drive specified is not valid.  This may be reported after
  962.     a critical hardware error.
  963.  
  964. Invalid Argument
  965.   - The swapping path is invalid
  966.  
  967. Can't find 'XXXXXX.XXX'
  968.   - Program that was to be executed was not there.  Be sure that the
  969.     program has a fully specified path name and is spelled correctly.
  970.  
  971. Not enough memory to exec xxxxxxxx.xxx
  972.   - There was not enough memory to execute the specified program.  This
  973.     error might occur if there are too many TSR programs in memory or
  974.     ZGEN is executed from another program.
  975.  
  976. 21
  977.  
  978. Error in the exec of xxxxxxxx.xxx
  979.   - Some other error occurred in the exec of the specified
  980.     program.
  981.  
  982. Unable to Copy
  983.   - The destination disk is may full or write protected, or the
  984.     you are attempting to overwrite a file with the readonly bit
  985.     set or a subdirectory with the same name.
  986.  
  987. Unable to remove xxxxxxxx.xxx
  988.   - ZGEN is unable to remove a sub directory.  You cannot remove
  989.     a directory that is on the path to the current directory or
  990.     directories with the readonly bit set.
  991.  
  992. Unable to delete xxxxxxxx.xxx
  993.   - ZGEN is unable to delete a file. The file may be read only, or
  994.     the disk is write protected.
  995.  
  996. Print spooler queue full, file not submitted
  997.   - The print spooler program PRINT.COM has reported that the queue
  998.     is full after an attempt to submit a file.  Try waiting until a
  999.     file is done printing or increase the queue buffer size for PRINT.COM
  1000.     with the /Q: option.  The default buffer size is 10 file names and
  1001.     can be increased to 32.  Refer to your DOS manual for more information.
  1002.  
  1003. Print spooler busy, file not submitted
  1004.   - The print spooler program has reported that it is busy.  Try waiting
  1005.     and then try again.
  1006.  
  1007. File name is too long, file not submitted
  1008.   - The name submitted to the print spooler is too long.  This could happen
  1009.     if the file is deeply nested in the subdirectory structure.
  1010.  
  1011. File not found by the print spooler
  1012.   - The print spooler reported that it could not find the file
  1013.  
  1014. Path not found by the print spooler
  1015.   - The print spooler reported that the path name of the file could
  1016.     not be found
  1017.  
  1018. Too many open files, file not submitted
  1019.   - The print spooler has reported that there are too many open files
  1020.     to print the file.  Try increasing the files parameter in the
  1021.     your systems config.sys file. Refer to your DOS manual for more
  1022.     information.
  1023.  
  1024. 22
  1025.  
  1026. Access denied, file not submitted
  1027.   - The print spooler was denied access to the file.  The file was probably
  1028.     locked.
  1029.  
  1030. Drive invalid, file not submitted
  1031.   - The print spooler has reported that the drive is invalid in the file
  1032.     submitted to it.
  1033.  
  1034. Unexpected print spooler error %x
  1035.   - The print spooler returned an unexpected error code.
  1036.  
  1037. Drive is no longer valid
  1038.   - Reported after a disk access that resulted in a critical error.  You
  1039.     will be prompted select a new drive.
  1040.  
  1041. Invalid .ZIP file
  1042.   - .ZIP file has a corrupted directory format.  Try using PKZIPFIX to
  1043.     repair the .ZIP file.
  1044.  
  1045. Not enough Memory
  1046.   - ZGEN has run out of dynamic memory.  This error should rarely
  1047.     occur.
  1048.  
  1049. Notes about ZGEN:
  1050.  
  1051. If you should ever encounter a bug in ZGEN, or have a suggestion to
  1052. improve the software, or find something unclear in the documentation,
  1053. feel free to notify the author.
  1054.  
  1055. The file ZGEN.EXE has been compressed by the program LZEXE 0.91 by
  1056. Fabrice Bellard.
  1057.  
  1058. I can be contacted via:
  1059.  
  1060. FidoNet at 1:147/38
  1061. USPS:   RWare Software Company
  1062.         P.O.B. 2714
  1063.         Norman, OK 73070-2714
  1064. Internet : mashlan@slinky.fidonet.org
  1065. BBS: 1-405-447-0944  ( 300/1200/2400 8N1 )
  1066.  
  1067. 23
  1068.  
  1069. Credits:
  1070.  
  1071. Thanks to Rod Wilson, Bill Arrington, Jerry Pults, Scott Sanbar, Vicki
  1072. Bombaci, Al Filandro and furlan primus for beta testing.  Thanks to Thad
  1073. Smith III for his many suggestions, Thanks to Darin Fox for beta testing
  1074. and free legal advice. Thanks to Rex Conn providing information on 4dos.
  1075. Special thanks to Ralph Brown for making his spawno code available
  1076. without royalties.
  1077.  
  1078. ZGEN was written by Robert Mashlan in C and assembler and compiled using
  1079. Borland C++ v2.00.
  1080.  
  1081. The swapping code in ZGEN is copyright, and was written by Ralph Brown
  1082. and was taken from his spawno C library.
  1083.  
  1084. The remainder of the code with exception of the Borland C standard
  1085. library were written by Robert Mashlan.
  1086.  
  1087. History:
  1088. 11-12-90   version 1.03
  1089.        first public release of ZGEN.
  1090.  
  1091. 12-7-90    version 1.22
  1092.        added pop-up menus
  1093.        added mouse support
  1094.        added swapping options
  1095.  
  1096.  1-1-90    version 1.37
  1097.        added .ARJ file support
  1098.        added %s and %ns command macros
  1099.  
  1100. 2-4-90       version 1.46
  1101.        several bug fixes
  1102.        added duplicate file ability
  1103.        added high intensity background color attributes
  1104.        added executable extensions feature
  1105.            added command line functions
  1106.  
  1107. 6-10-91    version 1.60
  1108.            even more bug fixes
  1109.            menu rearrangement, mouse handling improved
  1110.            added %^ command line operator
  1111.            added '#' number matching wildcard
  1112.            added format floppy program ability
  1113.            now recognizes LHA level 2 headers
  1114.            recognition of self extracting archives
  1115.            use of ZGEN environmental variable to specify directory
  1116.            for ZGEN.CFG and ZGEN.TRx files.
  1117.  
  1118. 24
  1119.